<html lang="en" xml:lang="en"><head>
<META http-equiv="Content-Type" content="text/html">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"><META name="description" content="Frequently Asked Questions"><meta name="content-language" content="en"><link href="rsrc/htmlhelp.css" rel="stylesheet" type="text/css"><title>Web AppBuilder for ArcGIS | Help - 
FAQs
</title>
                <script type="text/javascript" language="JavaScript">
                    var pathL  = self.location.pathname.split ("/");
                    var fname = pathL[pathL.length-1];
                    var i = fname.lastIndexOf (".htm");
                    if (i>=0) {
                    fname = fname.substring (0, i)
                    } else {
                    //??
                    }
                    if (self.location.hash) {
				    		      fname = fname + self.location.hash;
						        }
                    self.location.replace ("../index.html#//" + fname);
                </script>
                </head><!--Publication GUID: [GUID-E7D1C130-8F87-4109-8D61-E73A46083F52]--><!--Topic GUID: [GUID-A66EA044-37C7-4DD0-877C-DB916D3D703E]--><body><div id="content"><div class="header"><h1>
FAQs
</h1><div id="breadcrumb"></div></div>
    <p id="GUID-7939FDA3-8EDB-494C-A05F-FAA79BDB9153">
      
    </p>
    <p id="GUID-14DDBF98-E125-4DD3-A5C1-0AD514CA818A">
      <b>How do I start Web AppBuilder for ArcGIS (Developer Edition)?</b>
    </p>
    <p id="GUID-520108DF-BBD7-42C7-A249-CDC8027DB000">See <a class="xref" rel="03w3/03w30000005r000000.htm" href="03w3/03w30000005r000000.htm">Get started</a>.</p>
    <p id="GUID-D89EFE86-4572-464B-981E-EDEB1E7C9EB5">
      <b> What should I do when I try to set the App ID and  encounter  an Invalid redirect_uri error?</b>
    </p>
    <p id="GUID-94A17D4E-4A21-47DB-AF85-7ED60B405A3F"> It is   indicated that the URI of Web AppBuilder  is not added or set correctly in the Redirect URI list when you registered the App ID for  Web AppBuilder in the ArcGIS portal. Complete the following steps: <ol purpose="ol" id="OL_6E042DFFCFAE488D9CAA49C1EB67B30C"><li purpose="li" id="LI_FA5A60C59EF0431BB70BCC05AF6DDE97">Go to  <span class="usertext">/server</span> directory of  the Web AppBuilder installation, delete signininfo.json file.</li><li purpose="li" id="LI_B3C37271556A450E9DFF8D09C05A0EBD">Review  step 4. Update the existing App ID with the correct redirect URIs. see <a class="xref" target="_blank" rel="http://server.arcgis.com/en/portal/latest/administer/windows/add-items.htm" href="http://server.arcgis.com/en/portal/latest/administer/windows/add-items.htm">View and update app registration info</a>. Alternatively, you can create a new App ID from the scratch.</li><li purpose="li" id="LI_F8FAD64B2D6B46EB9141BE9B0C967F4F">Refresh the browser running Web AppBuilder.</li><li purpose="li" id="LI_12D40E8679604E58840BA60545D307AD">Provide your App ID again, and click <span class="uicontrol">Continue</span>.</li></ol></p>
    <p id="GUID-AF22F46C-B897-4704-ABBA-6260DB3CA00C">
      <b>How do I start Web AppBuilder for ArcGIS (Developer Edition) in HTTPS   websites with my CA-signed certificate?</b>
    </p>
    <p id="GUID-A4109D01-F88D-418A-B54B-6AF8B21065EC">Web AppBuilder uses a self-signed certificate in Node.js to support HTTPS. If you want to start Web AppBuilder in your full HTTPS site, you can use your own certificate. To do so, replace two files in the server directory: cakey.pem and cacert.pem. See <a target="_blank" class="xref" href="https://nodejs.org/api/https.html" rel="https://nodejs.org/api/https.html">nodejs</a> and <span class="usertext">https://www.openssl.org/docs/faq.html#USER3</span> for more information.</p>
    <p id="GUID-6AE17FB0-68BB-43BA-8D04-B6EBA9C84A4F">
      <b>How do I use the local help?</b>
    </p>
    <p id="GUID-227558F2-06CC-4FA2-9103-559214CBC227">You can start the Web AppBuilder help in a browser with <span class="usertext">http://[yourmachinename]:[port]/webappbuilder/help</span> after Node.js starts, or go to the docs folder for the Web AppBuilder installation by right-clicking the index.html file, and then open it with Firefox or Internet Explorer (IE). If you choose the latter option, be aware that Chrome does not support this HTML format, while with IE10 or later,  you need to  enable JavaScript before continuing. </p>
    <p id="GUID-D77E7E07-F3FF-49A1-B086-F92ED17344EB">
      <b>What should I do when I fail to log in to my ArcGIS Online organization or Portal for ArcGIS?</b>
    </p>
    <p id="GUID-A652B81A-27EB-4E4B-BDA7-D3287F5E6450">You may fail to log in to your ArcGIS Online organization or Portal for ArcGIS due to one of the following:</p>
    <ul purpose="ul" id="UL_6B9327170B3444C29E2267F3EF2108C0">
      <li purpose="li" id="LI_4B10EBF5D6D4497389A8E9B4D065B84E">No trusted certification available. To work around it, log in to your portal first to make  the certificate trusted, and then log in to Web AppBuilder again.</li>
      <li purpose="li" id="LI_3C65B0E0687244508705965FB4532E9D"> Need proxy to access
externally. To work around it,  set the  proxy for Web AppBuilder  from node
command  <span class="usertext">node server.js
[-proxy=value]</span>.</li>
    </ul>
    <p id="GUID-1D4203E1-0FAD-462C-B891-4CEC8F471E1F">
      <b> How can I update the App ID for Web AppBuilder for ArcGIS (Developer Edition)?</b>
    </p>
    <p id="GUID-6669D4BC-4579-49DB-BFBE-20B2D9DC62A2"> The  App ID is set  when you start Web AppBuilder for the first time. To update it, open the signininfo.json file in the
server folder, and then edit the appID property specified in the portal.</p>
    <p id="GUID-17889D69-707C-4D5A-B0D9-809DF0BEA62F">
      <b>Is SSL-enabled access   supported? </b>
    </p>
    <p id="GUID-B9CADDA2-09D5-45CE-A053-5BD8AB66A3A0">Yes. Web AppBuilder supports   SSL-enabled  access to online organizations or Portal for ArcGIS. The HTTPS request is required when the URL to the  organization or Portal for ArcGIS is specified.</p>
    <p id="GUID-87C76E38-0F38-4BF8-9AED-50C785A7EE6A">
      <b>Which portal securities are supported?</b>
    </p>
    <p id="GUID-C00FD43F-C97A-410D-918D-9BEA6E76CBB3">Portals with the following securities are supported by Web AppBuilder:</p>
    <ul purpose="ul" id="UL_2C5F0CCA26EB4ECAB2E3E2CA594CC02E">
      <li purpose="li" id="LI_DA647C0743464DFBA263BCCFE603D6DF">OAuth</li>
      <li purpose="li" id="LI_60F62CCD228A4CB997A6118201B5C676">SAML</li>
      <li purpose="li" id="LI_9992C380466943618234F232D2C72165">IWA</li>
      <li purpose="li" id="LI_979E72B2866E483480327864B6CB0FB8">PKI</li>
      <li purpose="li" id="LI_3C7C85141BB4450CB98082415F13B1CD">LDAP</li>
    </ul>
    <p id="GUID-855512D4-0F9C-425D-9997-A9BC10B294DD">
      <b>What should I do if I have an error when running Web AppBuilder on Microsoft Edge?</b>
    </p><p id="GUID-E5A46ACF-F165-458A-82B3-2599D6D718A1"> Edge runs as a Windows modern app different from IE and thus it has network isolation by default for security reasons. If you have an error saying "Hmm, we can't reach this page.", read the<a target="_blank" class="xref" rel="http://blogs.msdn.com/b/msgulfcommunity/archive/2015/07/01/how-to-debug-localhost-on-microsoft-edge.aspx" href="http://blogs.msdn.com/b/msgulfcommunity/archive/2015/07/01/how-to-debug-localhost-on-microsoft-edge.aspx">blog</a> for a solution.</p><p id="GUID-0B637C21-FB2E-4E2F-8ABD-767EAB58DC1B">
      <b>Can I use Web AppBuilder for ArcGIS (Developer Edition) with IE8 or IE9 to access portals with web-tier authentication?</b>
    </p>
    <p id="GUID-1F31CBC8-B357-482D-8B85-BED48CAA2553">No. Web AppBuilder  for ArcGIS (Developer Edition) does not support using IE8 or IE9 to access the  portal with web-tier authentication. This is due to the limitation of IE8 and IE9 not  supporting Cross-Origin Resource Sharing (CORS).</p>
    <p id="GUID-8BD3C43B-48B9-4AA0-9830-A3E180A49D36">
      <b>What should I do  when I fail to start Web AppBuilder by specifying a URL to a portal with   LDAP authentication? </b>
    </p>
    <p id="GUID-E8EA651D-F830-44C8-AA73-90ED9E1F6A1F">When you start Web AppBuilder by specifying a URL to a portal with LDAP authentication, you may encounter this error:  Unable to access [Portal_URL]. A Server with specified hostname could not be found. This is probably caused by the SSL support in the node server not matching the SSL version of
the LDAP server. To work around it, stop the node server, and then
start it with command lines.  </p>
    <p id="GUID-53913F09-78BE-462B-B3FB-538129FEE30B">Open a command window and browse to the server directory of
the Web AppBuilder installation.</p>
    <p id="GUID-485FD4F6-B062-4286-AF87-72C068B2E58E">
      On 64-bit Windows, type <span class="usertext">node_x64.exe server.js
-sslClientVersion=SSLv3_method</span>.</p>
    <p id="GUID-EFAD3CB8-035D-49F9-A11F-AAEE546B344C">On 32-bit Windows, type <span class="usertext">node_x32.exe server.js
-sslClientVersion=SSLv3_method</span>.</p>
    <p id="GUID-094C7773-A085-4C9D-BDCE-F5CF60CB9053">On other platforms, type <span class="usertext">node server.js
-sslClientVersion=SSLv3_method</span>.</p>
    <p id="GUID-02CEF703-EF0A-41E6-8177-B68AD801801B">
      <b>Are  portals with disconnected environments supported?</b>
    </p>
    <p id="GUID-5C398E64-421D-4461-883C-4D83A2C40C22">Yes. You must set  your own apiURL manually in the env.js file.  Refer to <a class="xref" rel="03w3/03w30000000m000000.htm" href="03w3/03w30000000m000000.htm">Change URL of ArcGIS API for JavaScript</a>. By default, Web AppBuilder points to the ArcGIS API for JavaScript hosted by ArcGIS.com.</p>
    <p id="GUID-1D1D31E0-649F-4827-B9BF-A18D3DBA6355">
      <b> Why can't my deployed app access cross-domain resources?</b>
    </p>
    <p id="GUID-A7434FB6-EA39-4D24-9AE0-03CA84FE0462">You need to set the appropriate proxy in the app config.json file. Refer to <a class="xref" rel="03w3/03w30000004z000000.htm" href="03w3/03w30000004z000000.htm">Use proxy</a>.</p>
    <p id="GUID-9727B4DA-093B-4B0C-86E4-AD5E9508BCF2">
      <b>Do I have to register  my downloaded app for  deployment?</b>
    </p>
    <p id="GUID-2DFECE5F-06D5-4CE6-8D34-2A685A4E2A8E"> The app created by Web AppBuilder can be downloaded and hosted on your web server. Any app that is downloaded must be registered with ArcGIS Online or Portal for ArcGIS if the app references nonpublic items. Refer to <a class="xref" rel="03w3/03w30000004v000000.htm" href="03w3/03w30000004v000000.htm">Deploy app</a>.</p>
    <p id="GUID-93098727-9647-4AEC-B00A-2F90A7DEEC2E">
      <b>Which versions of Portal for ArcGIS should I use?</b>
    </p>
    <p id="GUID-93972083-74E5-495B-9764-50F5942BC0C1"> Web AppBuilder supports Portal for ArcGIS 10.3 and later. If you have Portal for ArcGIS 10.2.2 or 10.2.1, it is recommended that you  upgrade to 10.3 and later.</p>
    <p id="GUID-5F60D9FB-0F73-41A1-BAF0-8F9F9E551016">
      <b>Can I use Portal for ArcGIS 10.2.2 and 10.2.1?</b>
    </p>
    <p id="GUID-3BD59DBF-D1F6-4956-87E6-C80D786F5237">Although Web AppBuilder should work with Portal for ArcGIS 10.2.1 and 10.2.2, you are at risk if you prefer to use them,  as  they  are not supported.</p>
    <p id="GUID-32230058-4B3F-4BC9-AFB9-75DA9F48DE50">
      <b>Which versions of ArcGIS API for JavaScript should I use?</b>
    </p>
    <p id="GUID-24C7039D-2AD5-431A-BC15-E35F335449C0">Web AppBuilder 1.0 supports ArcGIS API for JavaScript 3.12. In the future releases, the latest release of Web AppBuilder  always synchronizes with the latest release of  ArcGIS API for JavaScript. </p>
    <p id="GUID-1D1F76C1-0DA4-4C60-B268-2412609A4E93">
      <b>Which versions of ArcGIS for Server should I use?</b>
    </p>
    <p id="GUID-575227F2-16E2-4093-A3E6-354029AAACA1">It is depended on the versions of ArcGIS Server that your ArcGIS portal supports.</p>
  <div class="footer"> Copyright © 1995-2016 Esri. All rights reserved. </div></div></body></html>